home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / xfs_chver.z / xfs_chver
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. xxxxffffssss____cccchhhhvvvveeeerrrr((((1111MMMM))))                                                    xxxxffffssss____cccchhhhvvvveeeerrrr((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      xfs_chver - change the version of a filesystem to enable the extent
  10.      unwritten version.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      xxxxffffssss____cccchhhhvvvveeeerrrr [ ----ffff ] ----aaaa
  14.  
  15.      xxxxffffssss____cccchhhhvvvveeeerrrr [ ----ffff ] devices
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _x_f_s__c_h_v_e_r uses the _x_f_s__d_b command to change the version of a filesystem
  19.      to enable the extent unwritten version.  This version is needed to close
  20.      a security hole where a process can sometimes read old data off disk.
  21.  
  22.      The command must be run by the super-user.  The command either does all
  23.      devices found in _f_s_t_a_b(_4) when the -a option is used or the given devices
  24.      from the second form above.
  25.  
  26.      The command either does the changes or creates scripts which can later be
  27.      applied using the _x_f_s__d_b command.  If the -f option is used, scripts are
  28.      created and not applied.  Without the -f option, the scripts are created,
  29.      applied using _x_f_s__d_b, and removed.
  30.  
  31.      Devices that are mounted cannot be converted.  This is always true for
  32.      the root filesystem.  Administrators must unmount filesystems before
  33.      _x_f_s__c_h_v_e_r or _x_f_s__d_b can convert the version.  If a device being converted
  34.      is found in _m_t_a_b(_4), the conversion is not attempted and an appropriate
  35.      message is printed.  It is safe to run this command on mounted devices as
  36.      they are just skipped.
  37.  
  38.      It is also safe to re-run the command multiple times on the same devices.
  39.      If the device is already converted or inaccessible, a simple message is
  40.      printed and the command continues with the next device.
  41.  
  42.      The -f option causes the xfs_chver command to reduce error checking and
  43.      create file(s) which can be passed to _x_f_s__d_b. These files are created in
  44.      the current directory in the form <device>.xfs_chver.  These files can be
  45.      applied to the filesystem, invoke the following command:
  46.  
  47.           xfs_db -x <device> < <device>.xfs_chver
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. xxxxffffssss____cccchhhhvvvveeeerrrr((((1111MMMM))))                                                    xxxxffffssss____cccchhhhvvvveeeerrrr((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      When the -f options is given, the following conditions are not checked
  75.      for the device(s):
  76.  
  77.           o - is the device the root filesystem,
  78.  
  79.           o - is the device mounted,
  80.  
  81.           o - can the user write to the device.
  82.  
  83.      When the -f option is not used, the device is checked with /dev/root.  If
  84.      a device has the same _s_t__r_d_e_v, as the root device, i.e. /dev/root, the
  85.      conversion is not attempted and a message is printed.  The root can only
  86.      be converted if another filesystem is used as a root and the "current
  87.      root" filesystem is accessed from the other root.
  88.  
  89.      Another alternative to convert the root is to use the -f option.  The
  90.      created file should be saved on the root to convert.  Next, boot the
  91.      miniroot and mount the root to convert.  Next, copy the file just created
  92.      with the -f option and the _x_f_s__d_b command (usually found in
  93.      /usr/sbin/xfs_db) onto the mini root.  Now, unmount the root to convert.
  94.      Then run the command:
  95.  
  96.           xfs_db -x <device> < <script>
  97.  
  98.      where <device> is the root device and <script> is the file created with
  99.      the -f option above.
  100.  
  101. EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  102.      A status of 1 is returned if the usage is incorrect, e.g. -a is used with
  103.      a device name or an unrecognized parameter is detected.  All other cases
  104.      return a status of 0, even if a filesystem is skipped.
  105.  
  106. BBBBUUUUGGGGSSSS
  107.      The xfs_db man page does not exist, yet.
  108.  
  109.      cat <script> | xfs_db -x <device> does not work.  Use xfs_db -x <device>
  110.      < <script>.
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      xfs_db(1M), mstat(4), fstab(4), mkfs_xfs(1M), xfs(4).
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.